iT邦幫忙

第 12 屆 iThome 鐵人賽

DAY 7
1

本篇同步發文在個人Blog: 一袋.NET要扛幾樓?打造容器化的ASP.NET Core網站!系列文章 - (7) 建立商品服務的Api - 5

 1. 建立Dockerfile

  在CatalogApi專案右鍵=>加入=>Dokcer支援,選擇目標平台Linux,將會在根目錄新增Dockerfile檔案,但這Dokcerfile有一些Bug,因為我的專案目錄設計方式,會讓VS產生錯誤的連結,所以需要再手動修改,變成下方的內容。其內容主要功能是在Docker容器內載入NET Core SDK編譯我們的程式碼,將編譯後的目錄檔案複製到Runtime環境的/app目錄,再用NET Core Runtime執行商品服務的Api系統。

    FROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster AS build
    
    WORKDIR /code
    EXPOSE 80
    
    COPY . .
    
    RUN dotnet restore
    
    RUN dotnet publish -o /out/ -c Release
    
    FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base
    
    COPY --from=build /out /app/
    
    WORKDIR /app
    
    ENTRYPOINT ["dotnet", "CatalogApi.dll"]

 2. 修改dokcer-compose.yml

之前已經在docker-compose.yml加入SQL Server的image,而這次要加上商品服務的Api,如下方的yml。主要的參數包含:

  • build的dockerfile:Dockerfile的檔名
  • build的context:我們商品服務Api的Dockerfile所在的目錄
  • image:這商品服務Api的image命名
  • environment:這些參數將會覆蓋appSettings.json的內容,包含資料庫的連線資訊、外部連到此服務的URL。其中ExternalCatalogBaseUrl的{}值會從.env檔的內容做替換
  • ports:將此Api的80 port對應為本機的7000
  • depends_on:需要先等SQL Server的容器啟動完,才輪到此Api啟動容器
  • networks:新增一個frontend網路區域,之後會和網頁前端系統互通
    version: "3.4"
    
    networks:
       frontend:
       backend:
       
    services:
       catalog:
          build:
             context: .\src\Services\CatalogApi
             dockerfile: Dockerfile
          image: rpgshop/catalog
          environment:
             - DatabaseServer=mssqlserver
             - DatabaseName=CatalogDb
             - DatabaseUser=sa
             - DatabasePassword=JustTest!
             - ExternalCatalogBaseUrl=http://${RPGSHOP_EXTERNAL_DNS_NAME_OR_IP}:7000
          container_name: rpgcatalogapi
          ports:
             - "7000:80"
          networks:
             - backend
             - frontend
          depends_on:
             - mssqlserver
    
       mssqlserver:
          image: "microsoft/mssql-server-linux:latest"
          ports:
             - "1445:1433"
          container_name: rpgmssqlcontainer
          environment:
             - ACCEPT_EULA=Y
             - SA_PASSWORD=JustTest!
          networks:
             - backend

 3. 建立.env檔

  .env檔是一種環境變數檔,用key=value的方式寫在此檔案,目前我們只需要放一筆資料:

RPGSHOP_EXTERNAL_DNS_NAME_OR_IP=docker.for.win.localhost

  這是前述的ExternalCatalogBaseUrl的值會被替換,而docker.for.win.localhost是docker內建在Windows的host。

 4. 用cmd執行docker-compose

  用cmd在docker-compose.yml所在位置輸入指令:

    docker-compose up

  執行完後,在瀏覽器輸入http://docker.for.win.localhost:7000/swagger ,將看見容器化的商品服務API,如圖1,且使用try it out都是正常運作。

圖1


這一系列的專案將開在這Github:RPGShopOnContainers,會依照文章的主題進度區分資料夾,有需要的人可自行pull / download~

下一篇將建立一套網站前端,整合商品服務的API作商品呈現。


上一篇
[Day 6] 建立商品服務的Api - 4
下一篇
[Day 8] 建立商品列表的頁面 - 1
系列文
一袋.NET要扛幾樓?打造容器化的ASP.NET Core網站!30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言